Recurring Payments
Tokenise - Phase 1 - Flow diagram
Request
Production Url
UAT Url
QA Url
https://psp.vodacompaymentgateway.co.za/recurringPayment/tokenize
Encryption Xml
Encryption Xml Xsd
Encryption Xml Description

<Transaction>
    <Amount></Amount>
    <Currency></Currency>
    <Password></Password>
    <Username></Username>
    <Identifier></Identifier>
    <TransactionType></TransactionType>
    <PayserverAlias></PayserverAlias>
    <Product>
        <Type></Type>
        <SalesType></SalesType>
        <Reference></Reference>
        <ProductCode></ProductCode>
        <ProductAmount></ProductAmount>
        <ProductDescription></ProductDescription>
    </Product>
    <MerchantReference></MerchantReference>
    <RequestIdentifier></RequestIdentifier>
    <CustomerIdentifier></CustomerIdentifier>
    <MerchantTokenReference></MerchantTokenReference>	
    <MerchantIdentifier></MerchantIdentifier>
    <RecurringAction></RecurringAction>
    <NotifyUrl></NotifyUrl>
    <FailureUrl></FailureUrl>
    <ReturnUrl></ReturnUrl>
    <WebHooks>
        <WebHook>
	    <Template></Template>
	    <Type></Type>
	    <Url></Url>
        </WebHook>
    </WebHooks>
</Transaction>
Form Post










  
Immediate Response
Transaction Response














    
Async Response
Transaction Response
Base64 decoded from the webhookpayload received from the initial payload. Below are the fields that can be sent back to the merchant.

{
  "Type":"RecurringPaymentCallBack",
  "ControlKey":"#ControlKey#",
  "Identifier": "#Identifier#",
  "MerchantReference": "#MerchantReference#",
  "Amount": "#Amount#",
  "RequestIdentifier": "#RequestIdentifier#",
  "TransactionReference": "#TransactionReference#",
  "TransactionId": "#TransactionId#",
  "ErrorDescription": "#ErrorDescription#",
  "ErrorCode": "#ErrorCode#",
  "BankResponseDescription": "#BankResponseDescription#",
  "BankResponseCode": "#BankResponseCode#",
  "TransactionStatus": "#TransactionStatus#",
  "Currency": "#Currency#",
  "SupplierID": "#SupplierID#",
  "Stamp": "#Stamp#",
  "CustomerIdentifier": "#CustomerIdentifier#",
  "MerchantIdentifier": "#MerchantIdentifier#",
  "MaskedCardNumber": "#MaskedCardNumber#",
  "RetrievalReferenceNumber": "#RetrievalReferenceNumber#"
}
    
Post Back
Tokenise Response
This response is async and relys on the bank for a response.

{
  "merchantid": "",
  "tokenstatusid": "",
  "merchanttokenid": "",
  "bankresponsemessage": "",
  "merchanttokenreference": "",
  "merchantcustomerreference": "",
  "tokenstatus": ""
}
    
Payment - Phase 2 - Flow diagram
Request
Production Url
UAT Url
QA Url
https://psp.vodacompaymentgateway.co.za/api/recurring/pay
Encryption Xml
Encryption Xml Xsd


    
    
    
    
    
        
        
        
        
        
        
            
            
            
            
            
        
    
        
        
        
        
        
        
        
        
            
            
            
            
            
        
    

  
API Post

{
  "PayserverUsername": "",
  "EncryptionType": "",
  "EncryptionSalt": "",
  "EncryptionIterations": 0,
  "EncryptionIv": "",
  "EncryptionXml": ""
}
    
Response
Payment Response

{
  "WasSuccessful": true,
  "Message": "",
  "Error": {
    "ErrorCode": "",
    "ErrorDescription": ""
  },
  "Exception": {
    "Message": "",
    "Source": "",
    "StackTrace": "",
    "InnerException": {},
  }
}
    
Post Back
payment Response

{
  "id": "",
  "statusid": "",
  "authcode": "",
  "ordernumber": "",
  "bankresponsemessage": "",
  "retrievalreferencenumber": "",
  "status": ""
}